GrowERP - Open Source Modular ERP Platform

License: CC0-1.0 Flutter Moqui

GrowERP is an open-source, multi-platform ERP application built with a modular architecture that allows for unprecedented extensibility and customization. Whether you're a small business or an enterprise, GrowERP adapts to your needs through its flexible building block system.

🚀 Quick Start

Try GrowERP Now

Production Applications: Require credit card with 2 weeks trial

Applications limited availability under test: dummy credit card always approved

Create a new company, select demo data, and explore! Login credentials will be sent to your email.

Install Locally (Easy Way)

dart pub global activate growerp
growerp install
Open in Firebase Studio

📚 Documentation

🚀 Quick Start: New to GrowERP? Start with the Extensibility Overview for a complete roadmap, then check the Building Blocks Guide for frontend development or the Backend Components Guide for backend development.

🏗️ Core Development & Architecture

🔧 Integration & APIs

🚀 Deployment & Operations

📋 Business & Management

🤝 Contributing & Community

📖 Additional Resources

📝 Documentation Status & Maintenance

The GrowERP documentation is actively maintained and regularly updated. Key features:

  • 📊 Comprehensive Coverage: 25+ detailed guides covering all aspects of development and deployment
  • 🔗 Cross-Referenced: All documents include links to related topics and examples
  • 🎯 Use Case Focused: Documentation organized by developer needs and experience levels
  • 📱 Multi-Platform: Covers Web, Android, iOS, Linux, Windows, and macOS development
  • 🤖 AI-Ready: Includes AI integration guides and MCP server documentation

💡 Documentation Navigation Tip: Start with the Extensibility Overview for a complete roadmap of all available documentation. Each guide includes cross-references and practical examples to help you find exactly what you need for your specific use case.

🔄 Contributing to Documentation: Found something missing or outdated? We welcome documentation contributions! See our Contributing Guide for how to improve the docs.

🏛️ Architecture Overview

GrowERP uses a modular architecture that promotes reusability and extensibility:

┌─────────────────────────────────────────────────────────────┐
│                    Applications Layer                        │
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────┐ │
│  │ Admin App   │ │ Hotel App   │ │Freelance App│ │Custom...│ │
│  └─────────────┘ └─────────────┘ └─────────────┘ └─────────┘ │
└─────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────┐
│                  Building Blocks Layer                      │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────┐ │
│ │growerp_core  │ │growerp_catalog│ │growerp_order │ │ ...  │ │
│ │growerp_models│ │growerp_inventory│ │_accounting  │ │      │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ └──────┘ │
└─────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────┐
│                    Backend Layer                            │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────┐ │
│ │GrowERP Comp. │ │Custom Comp.  │ │Mantle UDM    │ │Moqui │ │
│ │              │ │              │ │Mantle USL    │ │Frame │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ └──────┘ │
└─────────────────────────────────────────────────────────────┘

🧩 Building Blocks (Frontend)

  • growerp_core - Foundation templates and UI components
  • growerp_models - Data models and API clients
  • growerp_catalog - Product and category management
  • growerp_inventory - Warehouse and stock management
  • growerp_order_accounting - Orders, invoices, and accounting
  • growerp_user_company - User and company management
  • growerp_marketing - Marketing campaigns and analytics
  • growerp_website - Website content management
  • growerp_activity - Task and activity tracking
  • growerp_chat - Real-time communication

⚙️ Backend Components

  • Moqui Framework - Enterprise-grade backend framework
  • REST APIs - Automatic JSON serialization and authentication
  • Entity Engine - ORM with automatic CRUD operations
  • Service Engine - Business logic with transactions
  • Security - Role-based access control

🌟 Key Features

✨ For Businesses

  • Multi-platform - Web, Android, iOS from single codebase
  • Modular Design - Use only what you need
  • Industry-Specific - Pre-built applications for different sectors
  • Scalable - From small business to enterprise
  • Open Source - No licensing fees, full control

🛠️ For Developers

  • Extensible Architecture - Create custom building blocks and components
  • Modern Tech Stack - Flutter frontend, Moqui backend
  • Comprehensive Documentation - Detailed guides for all aspects
  • Active Community - Collaborative development environment
  • Best Practices - Established patterns and conventions

🏢 For Organizations

  • Cost Effective - 60% reduction in Total Cost of Ownership
  • Rapid Development - 50% faster application development
  • Customizable - Adapt to specific business requirements
  • Future-Proof - Modular architecture supports evolution
  • Community-Driven - Benefit from collective innovation

🚀 Getting Started

Prerequisites

Manual Installation

  1. Clone the repository:

    git clone https://github.com/growerp/growerp
cd growerp

  2. Start the backend (in separate terminal):

    cd moqui
# First time only
./gradlew build
java -jar moqui.war load types=seed,seed-initial,install no-run-es

# Regular startup
java -jar moqui.war no-run-es

  3. Run the Flutter application:

    cd flutter/packages/admin
# First time only
dart pub global activate melos 3.4.0
export PATH="$PATH":"$HOME/.pub-cache/bin"
melos clean
melos bootstrap
melos l10n --no-select
melos build --no-select

# Regular startup
flutter run

  4. Access the backend admin:

    • URL: http://localhost:8080/vapps
    • User: SystemSupport
    • Password: moqui

Docker Installation

For Docker-based installation, see the Docker README.

🎯 Use Cases & Applications

🏢 Admin Application

Complete ERP solution with:

  • Product catalog management
  • Inventory tracking
  • Order processing
  • Accounting and invoicing
  • User and company management
  • Website content management
  • Marketing campaigns

🏨 Hotel Application

Specialized for hospitality:

  • Room management
  • Reservation system
  • Guest services
  • Housekeeping
  • Billing and accounting

💼 Freelance Application

Project management focused:

  • Client management
  • Time tracking
  • Project organization
  • Invoicing
  • Activity monitoring

🔧 Custom Applications

Build your own using:

  • Existing building blocks
  • Custom components
  • Industry-specific workflows
  • Tailored user interfaces

🤝 Contributing

We welcome contributions from developers of all skill levels! Here's how you can help:

🎯 Contribution Areas

  • 🐛 Bug Fixes - Report and fix issues
  • ✨ New Features - Building blocks, backend components, integrations
  • 📚 Documentation - Improve guides, add examples, translations
  • 🧪 Testing - Unit tests, integration tests, quality assurance
  • 🎨 UI/UX - Design improvements, accessibility, themes

🚀 Getting Started

  1. Read our Contributing Guide
  2. Check the Extensibility Documentation
  3. Follow our Code of Conduct
  4. Join the community discussions

📈 High-Priority Areas

  • Industry-specific building blocks (healthcare, education, manufacturing)
  • Integration modules (payment, shipping, analytics)
  • Localization and internationalization
  • Performance and scalability improvements

📱 Screenshots

Admin Application

Mobile Screenshots

Main MenuProductsWebsite
AccountingLedgerCompany

Web/Tablet Screenshots

Main Menu
Company Management
Website Management
Order Management
Accounting
Ledger
Product Catalog

Hotel Application

Mobile Screenshots

Daily ViewWeekly MenuRooms
ReservationsAccountingLedger

Web/Tablet Screenshots

Daily View
Weekly View
Room Management
Reservation System
Accounting
Financial Ledger

Generated Business Website

E-commerce Website

🌐 Community & Support

📞 Contact & Support

🤝 Community

  • Contributors: Join our growing community of developers
  • Documentation: Help improve and translate documentation
  • Testing: Test new features and report issues
  • Mentorship: Learn from experienced contributors

📈 Project Status

  • License: CC0 1.0 Universal (Public Domain)
  • Status: Active development
  • Stability: Production ready
  • Community: Growing open source ecosystem

🎯 Roadmap

🔮 Upcoming Features

  • Enhanced mobile responsiveness
  • Advanced reporting and analytics
  • Additional industry-specific modules
  • Improved internationalization
  • Performance optimizations

🚀 Long-term Vision

  • Comprehensive ecosystem of building blocks
  • Industry-leading extensibility platform
  • Global community of contributors
  • Enterprise-grade scalability and performance

🌟 Star this repository if you find GrowERP useful!

🤝 Join our community and help shape the future of open-source ERP!

⭐ Star • 🍴 Fork • 📝 Contribute • 💬 Discuss